Rrr-duino for Model Railroading 
a Hands-on approach! 

Part 2 



by Speed 


(Gert 'Jim' Muller) 


Introduction: 


For someone who has not seen Part 1 of this Clinic, we decided to do a 
hands-on or make-and-take clinic where everyone bought some 
parts: an Arduino Nano, USB cable, 9g Servo motor, breadboard, 3mm 
LEDs of many colors, some FETs a push button and a light sensor. (Oh 
and wires to connect things together) 

What was never shown in the previous slides: Everyone installed the 
CH340 device driver, so the Nano shows up as COMx in Device 
Manager as well as the Arduino Software from arduino.ee 

What was also hinted in the previous slides: Everything we have done 
or emailed in the past, is shown on the TxNamib website: 
http://www.txnamib.com/electronics-and-software/rrrduino-for-model- 
railroads 


Setup 


Get your laptops up and running and plug the Nano in! 

[ PC -► USB Cable -► Nano ] 
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See a solid red light and a blinking red * light? 

Not? Then open File-> Examples-> 0 1 .Basics-> Blink 

in the Software and upload it! 


How 'bout now? 




What is an Arduino? 

Quoted: (http://www.circuitstoday.com/story-and-history-of-development-of-arduino) 


The new prototype board, the Arduino, created by Massimo Banzi and other founders, is a low COSt 
microcontroller board that allows even a novice to do great things in electronics. An Arduino can be 
connected to all kind of lights, motors, sensors and other devices; easy-to-leam programming language 
can be used to program how the new creation behaves. Using the Arduino, you can build an interactive 
display or a mobile robot or anything that you can imagine. 

You can purchase an Arduino board for just about US $30 or build your own board from scratch. 
Consequently, Arduino has become the most powerful open source hardware movement of its time. 


... but this was all said in Clinic Part 1, so lets move on!!! 


Things to Read (Easier) 





Make: 


c^* f 0 0 

Up DATCD! 
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The Open Source Electronics 
Prototyping Platform 
Massimo Banzi co founder of Arduino 

& Michael Shiloh 
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Things to Read (Harder) 


Recipes to Begin. Expand, and Enhance Your Projects 



Arduino 

~ " k 


O’REILLY' Michael Margolis 


John Baichtal. Matthew Becklcr, & Adam Wolf 

Make: LEGO and 

Arduino Projects Discovery 

Projects for Extending MINDSTORMS NXT 



O’Reilly- Malte: 




Arduino 


Ham Radio 


A Radio Amateur’s Guide to 
Open Source Electronics and $ 


Microcontroller Projects 


Glen Popiel, KW5GP 





Arduino Nano 
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Microcontroller 
Operating Voltage (logic level) 
Input Voltage (recommended) 
Input Voltage (limits) 

Digital I/O Pins 

Analog Input Pins 

DC Current per I/O Pin 

Flash Memory 

SRAM 

EEPROM 

Clock Speed 

Dimensions 

Length 

Width 

Weigth 


Atm el ATmega328 

5 V 
7-12 V 
6-20 V 

14 (of which 6 provide PWM output) 

8 

40 mA 0 

32 KB of which 2 KB used by bootloader 
2 KB 
1 KB 
16 MHz 
0.73” x 1.70" 

45 mm 
18 mm 
5 g 



A little more about Atmega328 "current" or mA 


ARDUINO UNO / Duemilanove CURRENT SOURCE/SXNK LIMITS 


-28. 


22 


2 i 


18 


ATMESA 328 Chip Pins 
Arduino Board Pins 
W |_ I PORT 


ycc 


CMD 


PDB^RXD 
PD 1 'TXB 
pycc pd2ximt0 
PD3^ IMT l^PUr* 


D 0 
kD 1 
' D2 
^03 


peri D 


PD4^T0/D4 


PDS-'T UPur ^D5 
PD6^fl IM0^PUI> ^D6 
PREF PD7^PINl 'D7 
PB0/ ICP /D9 
PB1 /QC UPU11/D9 
PB2/SS^PUM/D 10 
PB3/MOS I/PUM/ Dll 
-'RESET PB4^M ISO'D 12 
PB5'SCK' 313 
XTflLl PC0'rtDC0'D14 
PC 1 'ADC I'D 15 
XTAL2 PC2'ADC2'D 16 
PC3'ADC3'D 17 
PC4'ADC4'SDA'D10 
PC5'ADC5'SCL' D IS 
ATheQa328P-PU 


SOURCE TOTAL 150 mA • 

SOURCE TOTAL 150 mA- 

SINK TOTAL 100mA 

SINK TOTAL lOO mA 

SINK TOTAL lOO mA 
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ABSOLUTE MAXIMUM PER PIN 40 mA - RECOMMENDED 20 mA 


http://playground.arduino.cc/Main/ArduinoPinCurrentLimitations 


A Servo Following the Light! 



Servo Control to D3 (yel ) Light Sensor to AO (green) 

Why did we talk about mA in previous slide? So you know how many 4mA LEDs you can drive (or si nk ) and that the 
USB cable might not bring enough mA to keep your servo happy. 





Maybe you need to build a Dial of some sort? 



Servos? 


A servo motor has a built in control system to ensure that the position is maintained as commanded by sensing where it is 
and correcting any noticeable error. 

All the servos used in the model aircraft world, like our Micro 9g servo, is controlled by sending a pulse at 50 Hz (that is 
one pulse every 20 ms) 


h- Period 20 ms —t 



Pulse Width 1 ms (rrin.) -2 ms (max.) 


And the width of the pulse tells the servo where to move to. (Also know that you get servos that can only 90, 180 or 360 
degrees, and then continuous running ones where the speed of the servo is set buy the pulse width) 


P.1 nirrum Pulse 

h?t3se Width 1 ms 


Neutral Position 


^ Pulse Width 1.5 ms 



P.teximum Pulse 











T’ulse Width 2 ms 



And then there are some servos that can also move a little further when you give them a 0.5 ms pulse and/or further when 
they get a 2.5 ms pulse. 

The servo is also powered itself (5V in our case), and it must be able to provide enough current to maintain the servo's 
position and movement. Else it might jitter, or reset when told to move. Very common using a Nano on a 400mA USB 


/* lightServo . ino */ 


Code: 


#include <Servo.h> 

Servo myServo; 

int const anaPin = AO; 
int const servoPin = 3; 

int lightVal; 
int angle; 

void setup ( ) { 

pinMode ( anaPin, INPUT ) ; 
myServo . attach ( servoPin ); 
Serial . attach ( 9600 ); 

} // setup 

void loop ( ) { 

lightVal = analogRead( anaPin 


// include the servo library 
// create a servo object 

// analog pin used to connect the potentiometer 
// pin used to connect the servo 

// variable to read the value from the analog pin 
// variable to hold the angle for the servo motor 


// attaches the pin to the servo object 
// serial port, baud rate; 

// press Ctrl+Shift+M after upload 


// read the value of the potentiometer 


angle = map ( lightVal, 0, 1023, 0, 179 ); // scale the numbers from the sensor 


Serial . print ( lightVal ); 
Serial . print ( " -> " ); 
Serial . println ( angle ); 
myServo . write ( angle ); 


// show the value to us on the Serial port 

// show the angle to us on the Serial port 
// set the servo position 


delay ( 50 


// give the servo some time 


} // loop 


Coding: Formatting 

Space and Tabs do not matter (except when splitting words apart!) 

Making it look nice, helps reading and debugging it 

Comments gets removed, type more comments, even if you think you don't need it! /* for blocks */ 

#define and #include, preprocessor directives 

• #include puts the text from the file specified right there, imagine a copy-paste 

#include <Servo.h> 

• #defme will swop the next word with the text behind it 

#define myPIN 4 + 4 

Every ( must have a ), same with ", {} and [] 

{ and } creates code blocks 

if ( x == 1 ) doThis(); 

if ( x == 1 ) { 

doThis ( ) ; 
andAlsoDoThis () ; 

} 

Every statement ends with 


C and C++ are CASE sensitive, printLn ( ) ; is not the same as pRintln ( ) ; 


Coding: Variables 

A variable holds a value (or a bunch of them), we also have different types, or kinds 

int piggyBankCoins = 5; 
float piggyBankDollars = 0.25; 

char letter = 'a'; 

String txtMsg = "Hi there"; 

Just like your piggy bank, storing coins, how much money is in it? 

They can usually change, like adding a quarter to the piggy bank. 

Unless 

const int a = 5; // can never change, unless text changed here and recompiled 

Scope? A variable declared in a function or method can only be used IN that function 

Since you are the developer, you get to choose what name to use for your variable! 

a = b * c ; //is syntactically correct, but, its purpose is not evident. 

Contrast this with: 

weekly pay = hours worked * pay rate; 

Naming conventions: CamelCase, Delimiter in use, etc..., pick one and stick to it! 

int weekPay; int WeekPay; int decimalLocalWeekPay ; int dlWeekPay; 

How to decide, simple: if you were to read this code again in 2 years, what would make it the easiest to follow? 


Coding: Operators 

int a = 5 * b; // there are also +, -, /, %, ++, -, &, |, A , &&, | | and ! 

if ( a == b ) { } // there are also !=, >, <, <=, >= 

Keywords 

if, else, do, while, for, switch, case, default, break, goto, void, return 
types: void, int, float, double, char, register, enum, struct 
specifying: const, extern, volatile, long, short, signed, static, auto 

Short story, you can't use these as variable or function names! 

Functions or Methods 


You have seen: delay (x), pinMode (x, y ) , digitalWrite (x, y) , map (a, b, c, d) , random (x) 

A function performs some function, right? 

It might take zero or more values to do so: t ime = mi 1 1 i s ( ) ; or de 1 ay ( 10 0 0 ); 

It might give a value back time = millis(); ornotdelay( 1000 ); 

int sumTheseUp ( int x, int y ) { 

return x + y ; 

} // sumTheseUp 

void setup ( ) { 

pinMode ( sumTheseUp ( 1, 12 ), OUTPUT ); 

} / / setup 


A Serial Port and EEPROM using a Function! 
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The EEPROM provides a way to store values between power off and power on. 


1024 (8-bit) bytes on ATmega328 

Just like the SD Card in your camera, except this storage is already inside the Atmel chip! No card needed. 


A Serial Port and EEPROM using a Function (Code)! 


/* serialEEPROMLed . ino */ 

#include <EEPROM.h> // 

int ledPinl = 3; 

int incomingByte =0; // 

void setup ( ) { 

pinMode ( ledPinl, OUTPUT ); 

Serial . begin ( 9600 ); // 


analogWrite ( ledPinl, EEPROM [ 0 ] ); // 

} // setup 

void loop ( ) { 

checkincoming ( ); // 

} // loop 

void checkincoming ( ) { 

unsigned int answer = 0; 
if ( Serial . available ( ) > 0 ) { 

incomingByte = Serial. read ( ); 

if ( incomingByte == ' v' ) { 

Serial . print ( "You pressed 'v'!" ); 

} else if ( ( incomingByte >= 'O' ) && 

answer = ( incomingByte - 48 ) ; 
EEPROM [ 0 ] = 10 * answer; 
analogWrite ( ledPinl, EEPROM [ 0 
} else { 

Serial . print ( "I received: " ); 
Serial . println ( incomingByte, DEC 

} // else 

} // if serial available 
} // checkincoming 


include the EEPROM library 
for incoming serial data 

set as an output 

opens serial port, sets data rate to 9600 bp 
output EEPROM value to ledPinl, using PWM 


check incoming serial data 


check serial data 
read the incoming byte 

( incomingByte <= ' 9 ' ) ) { 

// zero based 

] ) ; 

// say what you got: 

) ; 


Multitasking! 

• We would like to use more than one pin on the Arduino to do something. Yes there are 20 pins to use. 

• If we use delay ( 10 00 ) ; to wait for the next Yellow traffic light to change to Red, then the Campfire, the Welder, 
the Grade Crossing, and the Servo moving based on the light value, ALL have to wait 1 second too! And that is going to 
make welding and campfire look pretty. Insert a delay ( 1000 ) ; at the end of the Welder code and see if you like it? 

• What if we could ask what the current time is and decide if we need to do something or not? So, we calculate how much 
time has expired since the last change, and if we exceed the threshold, we change! 

• Please meet millis(); 

Description 

Returns the number of milliseconds since the Arduino board began running the current program. This 
number will overflow (go back to zero), after approximately 50 days. 

#def ine CAMPFIREUPDATE 100 

#def ine TRAFFICUPDATE 1000 

Long int lastCampf ireChange = 0; 

long int lastTraf f icLightChange = 0; 

void loop ( ) { 

long int now = millis(); // get milliseconds since Arduino started 

if ( ( now - lastTraf f icLightChange ) > TRAFFICUPDATE ) { 

if ( tLight == HIGH ) tLight = LOW; else tLight = HIGH; 
digitalWrite ( TPIN, tLight ) ; 
lastTraf f icLightChange = now; 

} // if time for traffic to update 

if ( ( now - lastCampf ireChange ) > CAMPFIREUPDATE ) { 

... // lastCampf ireChange = now; 

} // if time for campfire to update 
} // loop 


OOP (Object Orientated Programming)? 

• Code and data are usually separate, you write functions and they act on the data you pass along, but what if I could store a 
method with my data? Don't worry, you have already used this, 

Servo myServo; myServo . attach ( pin ); myServo . write ( 50 ); 

• A very simple way to show the use of this, is to try to avoid using delay() and use millis() instead, but inside an object 
that contains its data. 

• OOP is not needed to do this, but it makes things a lot cleaner and easier to reuse your code somewhere else. On the 
previous slide, you need to repeat the code for every Campfire LED attached to every pin. 

• We could write code in the loop function to check millis() every time coming through, if a green light needs to be on, or if 
a yellow light needs to be one, or a red one, and, at the same time, if our campfire light needs to turn on or off. 


CampFire myFire ( firePin ) ; 

TrafficLite myLight ( redPin, greenPin, yellowPin, speed ); 
void setup () { 

// nothing need here, unless you need to want to do the pinModes here 
// but the constructors for the objects will take care of that this time 
} / / setup 

void loop() { 

myFire . update ( ) ; 
myLight . update ( ) ; 

} // loop 


/ / the number of the red LED pin 


class TrafficLite { 
int redPin; 
public : 

// Constructor - creates a TrafficLight 

// and initializes the member variables and state 

TrafficLite ( int rPin, int yPin, int gPin ) { 

redPin = rPin; 
pinMode ( redPin, OUTPUT ) ; 
output ( ) ; 

previousMillis = millisO; 

} // TrafficLite constructor 

void update () { 

// check to see if it's time to change the state of the LED 

unsigned long now = millisO; 
if ( now - previousMillis >= UPDATETIME ) { 

previousMillis = now; 
if ( countDown > 0 ) { 

count Down-- ; 

} else { 

ledState — ; 

switch ( ledState ) { 

case 0 : 

ledState = 3; 
case 1 : 

countDown = RED_TIME; 
break; 


}; // switch 

output ( ) ; 

} // time for change yet? 
} // if 
} // Update 
}; // TrafficLite 


• Complete example in TrafficLightOOP.ino, showing two traffic lights 

/* Traf f icLight_OOP . ino */ 

// 

// Class code here with update ( ) and other methods 

// 

Traf ficLite litel ( NS_REDPIN, NS_YELPIN, NS_GRNPIN ) ; 

Traf ficLite lite2 ( EW_REDPIN, EW_YELPIN, EW_GRNPIN ) ; 

void setup () { 

litel . go ( ) ; 
firstTime = 1; 

} // setup 

void loop() { 

if ( firstTime == 1 ) { 

if ( litel . isRed ( ) ) { 

lite2 . del ay St art ( ) ; 
firstTime = 0; 

} // if isRed 
} // if firstTime 
litel . update ( ) ; 
lite2 . update ( ) ; 

} // loop 


Traffic Light - OOP 
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Questions? 


References : 

— http : //www. chemistrylearninq . com/writing-c-proqram/ 

— http : / /www . kenleunq . ca/_portf olioassets /PDF/HistoryOf Arduino_KenLeunq . pdf 

— http : / /www . circuits today . com/story-and-history-of-development-of-arduino 

— www . Arduino . cc 

— http : // sumidacrossinq . orq/LavoutElectricitv/Arduinos/ArduinoShields/ 

— http : / /opendcc . source forge .net/ 

— http : //arduino . cc/en/Guide/ArduinoGSMShield 

— http : / /www . martvncurrev . com/ arduino-nano-as-an-isp-proqrammer / 


https : //www. servocitv. com/html/how_do_servos_work_.html# . VhheI_lViko 


Arduino Nano Pins, reference: 

• Purple (and green) numbers used in software, as labeled on edge of board. 

• Grey numbers are the Atmel chip's pin numbers, if you were to use the chip itself somewhere else! 
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